From dev-return-70569-archive-asf-public=cust-asf.ponee.io@activemq.apache.org Thu May 9 22:58:51 2019 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id E9192180649 for ; Fri, 10 May 2019 00:58:50 +0200 (CEST) Received: (qmail 70855 invoked by uid 500); 9 May 2019 22:58:50 -0000 Mailing-List: contact dev-help@activemq.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@activemq.apache.org Delivered-To: mailing list dev@activemq.apache.org Received: (qmail 70786 invoked by uid 99); 9 May 2019 22:58:46 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd3-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 09 May 2019 22:58:46 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd3-us-west.apache.org (ASF Mail Server at spamd3-us-west.apache.org) with ESMTP id D8B77181699 for ; Thu, 9 May 2019 22:58:45 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd3-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -0.201 X-Spam-Level: X-Spam-Status: No, score=-0.201 tagged_above=-999 required=6.31 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001] autolearn=disabled Authentication-Results: spamd3-us-west.apache.org (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com Received: from mx1-lw-us.apache.org ([10.40.0.8]) by localhost (spamd3-us-west.apache.org [10.40.0.10]) (amavisd-new, port 10024) with ESMTP id DlwEZODk83nW for ; Thu, 9 May 2019 22:58:44 +0000 (UTC) Received: from mail-ot1-f41.google.com (mail-ot1-f41.google.com [209.85.210.41]) by mx1-lw-us.apache.org (ASF Mail Server at mx1-lw-us.apache.org) with ESMTPS id 6823461136 for ; Thu, 9 May 2019 22:49:42 +0000 (UTC) Received: by mail-ot1-f41.google.com with SMTP id i8so3842610oth.10 for ; Thu, 09 May 2019 15:49:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to; bh=+oUZyYK727kAKLnIE8U6Z4GXQJSE9JSakwJrMgc+ltE=; b=FMk9RJ91BDp1KhOlAtN4rsN9FIWCCDh0n3oKoilTTqGhVKZANOM9LjV45+9+9XI/5Y BGJgPlF2gEvITU/L24NQJVy2LCAtP8xRGSQM2sgP/0AHGkgk9NpkpjKAoGlGKZ7xUlOe KRV2x6N05n/Br1CKDqqEjqitWVimIVlAsZc8Pnnn2LimOR1b8lW5eO5zi0h8eFLjbgE2 FLbYxXFXODCGDRgYWht/waaykFw3M/0Rctp70ODmLLoHjBOinK+K8JCTZM1Gq5+2/8Oc m9qIHFP00KLJJb+iV1x5ldDCtP9J4mQvdjYo4380zzVMKOeNLMxOeADp3HPDMmsPQtVq /zLw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to; bh=+oUZyYK727kAKLnIE8U6Z4GXQJSE9JSakwJrMgc+ltE=; b=CCP6kGz34ZArLqE22oXykZPwxTe8kyL8UeS71HhhLteawMU+Jj6c9gnUu3lH/QLjCU mkVKYFLFq1wLbic0P0/EYRMJxeenSfrrze+Yl1G0X7QdQfk7Lm4UyAn8ovnMhPfQviIT 8cx7BCt9ZEhWCn/tVAynGVnQZ/ew+SicjflhHPowBe7pBRh6UCuxGeveNsOB54hDPV/r jrEHDx7dXd+PerPNWQGFciRDDqaUTbSDazq89efLPbjRBa6TuqDNttGTug4Xv4XPjAuu /vHgz0CqhMtzQXUETZ9Ayf03AIrWT2l7T9238qyMRhZQldn0w28Bj+ARB5NRS8oCT4/1 Fe7w== X-Gm-Message-State: APjAAAWiZNSbFjqG14uuBND6fqRnJKZgBZRqRo3kNnDorWKptECV3Zw+ cadE/dkT2Ugohe/uZJZRyGX1GqOL8gfbIoBrFgjV/g== X-Google-Smtp-Source: APXvYqw+25gINYrIlyvrmJfFiag+hTbuB8vv4zBcQ6vOq2nDxxRtK73+lQsCRUKO14AUDj0AkjOsrFsQWH9YdmOU/UE= X-Received: by 2002:a9d:648f:: with SMTP id g15mr4288407otl.220.1557442181444; Thu, 09 May 2019 15:49:41 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Robbie Gemmell Date: Thu, 9 May 2019 23:49:32 +0100 Message-ID: Subject: Re: [DISCUSS] Artemis Documentation for older releases on WebSite To: dev@activemq.apache.org Content-Type: text/plain; charset="UTF-8" Thats definitely true, and why in the end I dont have a problem removing older releases content from the site. I do think having some period of release docs available on the site can be good though, as its easier for ourselves to point folks to relevant version-specific doc details if they are on the site, and regrettably many folks tend not to be on the current version. On Thu, 9 May 2019 at 18:19, Clebert Suconic wrote: > > I'm thinking about just keeping the _latest, as the download package > also includes the entire documentation. > > Someone willing to use the old version would be able to look at the > specific version.. or even github/docs. > > On Thu, May 9, 2019 at 5:44 AM Robbie Gemmell wrote: > > > > I think trimming older release doc content to keep the site managable > > is reasonable, and there are various approaches that could be used to > > trim things. Over at Qpid we tend to trim down to the last 2 years or > > so of release docs every now and then (its overdue currently, carrying > > just over 3). If taking an approach like that, as example there would > > clearly be old Artemis docs that could be removed. Another approach > > might be, removing even more docs for version streams not considered > > the current for some time, e.g maybe now all the 1.x Artemis docs > > could go except the latest 1.5.6 release. > > > > Looking at the size and content of the release docs themselves is > > perhaps also important. Having a peek at whats there currently for the > > refreshed ActiveMQ site, I see the 5.x javadocs are using about 400MB > > per release, but over half of it looks to be for source html. If so, I > > think thats of limited value personally, with IDEs often pulling > > source(+javadoc) jars directly and browsers having various web UI > > options such as GitHub etc to utilise. Thats >200MB per release I > > think we could perhaps remove and substitute with a link to the > > release tag. > > > > Robbie > > > > On Wed, 8 May 2019 at 22:25, Clebert Suconic wrote: > > > > > > Do we still need to provide documentation for older releases? > > > A big portion of the size now on the website is due to older releases. > > > > > > > > > I believe we should stop doing that, after all if you go to the > > > archive on previous releases, the binary will include documentations. > > > > -- > Clebert Suconic